home *** CD-ROM | disk | FTP | other *** search
/ Archive Magazine CD 1995 / Archive Magazine CD 1995.iso / discs / utilities / utility_02 / draw_eps / !Draw->EPS / !Help next >
Encoding:
Text File  |  1993-01-13  |  11.3 KB  |  386 lines
  1.                       
  2.                             CAREWARE
  3.                      
  4.  
  5.                         BETA TEST VERSION.                      
  6.  
  7.  
  8.                   !Draw->EPS Version 1.4 Readme.
  9.  
  10.  
  11.          THIS PROGRAM IS CAREWARE IS IS NOT PUBLIC DOMAIN
  12.                                         ~~~
  13.  
  14. The following have written permission to reproduce this software on
  15. their respective Careware disks :-
  16.  
  17.       Norwich Computer Services : Careware Disks
  18.       Alex Bar  (Furth Germany ): German Careware Disks
  19.  
  20. They will also be supplied with updates.
  21.  
  22. The Author will also upload it to Careware sections on Arcade and NCS bbs.
  23. From which it maybe downloaded.
  24.  
  25. It may NOT be uploaded by anyone other than the Author. 
  26.  
  27. It may NOT be reproduced by any other means ( other than above )
  28. without written consent of the author.
  29.  
  30. Arcade and NCS do NOT have authority to authorise copying by any means other than
  31. above.
  32.  
  33. Acknowledgments
  34. ~~~~~~~~~~~~~~~
  35.  
  36. I would like to thank Jonathan Cox and Peter Brunning for their assistance
  37. in Testing, Feedback and suggesting improvements.
  38.  
  39. Last updated 
  40. ~~~~~~~~~~~~
  41.    Application   : 12th October   1992
  42.    Documentation : 12th October   1992
  43.                                        
  44.                       
  45. !Draw->EPS is a Utility for converting Acorn Draw files to Encapsulated Postscript.
  46.  
  47. The idea behind Encapsulated Postscript is that it may be incorporated into another
  48. Document or Diagram. When the target application is producing its Postscript output
  49. it incorporates the Encapsulated Postscript files at the appropriate places. To
  50. this end it has to save and restore its state before and after each EPS file.
  51. Also EPS files must obey certain rules in order to not upset the saving and restoring
  52. of the Postscript environment.
  53.  
  54. The fact that EPS files are used in the above way, means that they are primarily
  55. only of use to those with access to Postscript Printers.
  56.                            
  57. As displaying Postscript is a non trivial task, some EPS file may contain preview
  58. images of the file making it easier for the user to view the file during editing
  59. of a document.
  60.  
  61. The preview section of the file is normally only used for display purposes 
  62. and printing will normally only use the native Postscript section. There are
  63. various preview formats dependant on the machine environment. Files with a preview 
  64. section are normally called EPSF files, apart from one preview type which
  65. uses a preview format which is aimed at interchanging between unlike machines
  66. and these are called EPSI files.
  67.                 
  68. Examples of Preview types :-
  69.  
  70.          Preview Type           Normal Machine Type    EPS Type
  71.                                                                        
  72.            Interchange               ALL                EPSI
  73.            TIFF                      PC's               EPSF
  74.            Metafile                  PC's               EPSF
  75.            PICT                      Macs               EPSF
  76.  
  77. To help with conversion of the Postscript section of an EPS File,
  78. a more limited form of Postscript maybe used, one such example is
  79. Adobe Illustrator format. 
  80.                     
  81. PostScript & Adobe Illustrator are trademarks of Adobe Systems Incorporated
  82.  
  83. Installation
  84. ~~~~~~~~~~~~
  85. The DrawEPS arc file should have been restored to a directory named
  86. !Draw->EPS. Which should contain the following files :-
  87.  
  88.  
  89.            !Run        : Draw->EPS Startup file.
  90.            !Sprites    : Draw->EPS Application Sprites
  91.            !Templates  : Template files
  92.            Draw-EPS    : Draw->EPS Application.
  93.            Palette     : Default conversion palette.
  94.            ~~config    : Configuration file for Draw->EPS.
  95.            !Help       : This file.
  96.  
  97. Tailoring.
  98. ~~~~~~~~~~
  99.  
  100.     The !run file should be altered to suite your requirements :-
  101.  
  102.  
  103.     Modules required :-
  104.  
  105.        The Shared C Library should be loaded as appropriate for
  106.        your setup. The supplied !run file assumes that the C
  107.        shared library module is in !system.modules.
  108.  
  109.        The Floating Point Emulator should be loaded as appropriate for
  110.        your setup. The supplied !run file assumes that the FPEmulator
  111.        module is in !system.modules.  
  112.                        
  113.     Variables required :-
  114.  
  115.        Draw-EPS$dir is required in order for draw->EPS to find its various
  116.        configuration files.
  117.  
  118.     Storage required :-
  119.  
  120.        !Draw->EPS has been tested with a wimpslot size of 128k
  121.        on a machine with 32k pages. lower values may be possible
  122.        on machines with smaller page sizes.
  123.  
  124.        The file to be converted is loaded into a buffer claimed from
  125.        the next slot. The space is return immediately after the conversion,
  126.        so you should not be able to see the change.
  127.        
  128.        If !Draw->EPS  prompts that it does not have enough memory to process, 
  129.        then !Draw->EPS must be restarted, having made provision that 
  130.        the next slot is large enough.     
  131.  
  132. Operation.
  133. ~~~~~~~~~~
  134.  
  135.      1) First click on the !Draw->EPS icon. This will install the !Draw->EPS
  136.         icon on the icon bar.
  137.  
  138.      2) To convert a Draw file, drag the file to the !Draw->EPS icon on
  139.         the icon bar. This will popup a save EPS window. Drag the EPS
  140.         file icon to the required destination. 
  141.  
  142. Control Options
  143. ~~~~~~~~~~~~~~~
  144.  
  145.       EPS Output Type
  146.       ---------------
  147.  
  148.       Controls type of Postscript generated.
  149.  
  150.       Plain       : Plain Postscript
  151.       
  152.       AI Format   : Adobe Illustrator Format Version 2
  153.  
  154.       Preview Type
  155.       ------------
  156.  
  157.       Controls the type of Preview section created
  158.  
  159.       None        : No Preview section created
  160.       
  161.       Interchange : Interchange format preview section.
  162.  
  163.       TIFF        : Tagged Interchange File Format
  164.  
  165.       Resolution
  166.  
  167.       Controls the resolution of the preview section, remember this
  168.       is normally only used for display purposes. 
  169.  
  170.                                                  
  171.       Direct Link
  172.       -----------
  173.  
  174.       Rather than have !Draw->EPS prompt for the target file, it is possible
  175.       to set a default path and have the target name created as default path
  176.       plus filename. To do this you drag the EPS file icon to the target directory
  177.       or application and set the Direct option. With the direct option set the
  178.       output EPS file will automatically be created.
  179.  
  180.       Note if you use this option sensibly with an application then the receiving
  181.       application must support the EPS file type.
  182.  
  183. Tiff Output
  184. ~~~~~~~~~~~
  185.  
  186.       As a side feature, !Draw->EPS may be used to extract the Tiff sections
  187.       from an EPS file. Drag the EPS file to the bar icon and a save box
  188.       for the TIFF file will be prompted.
  189.               
  190. Current Restrictions
  191. ~~~~~~~~~~~~~~~~~~~~
  192.  
  193.       Draw related
  194.       ------------
  195.  
  196.       Only Draw function available to Risc OS 2 is supported. Support of Risc OS
  197.       version 3 related function is subject to availability of RiscOS 3 and PRMS.
  198.       
  199.       Line endings are currently ignored.
  200.  
  201.       Sprites within Draw files are not yet supported.
  202.  
  203.       Text Areas are not supported.
  204.        
  205.       Preview Mode
  206.       ------------
  207.  
  208.       Previews are currently created by plotting the Draw file to a Mode 0
  209.       sprite, they therefore do not 100% represent the output as will be
  210.       seen on printing. In particular there will be no dithering for 
  211.       none black and white colours.
  212.  
  213.       Sprites and Text areas are not yet supported.
  214.  
  215.       TIFF Related
  216.       ------------
  217.  
  218.       The current implementation only outputs an uncompressed TIFF image with
  219.       a single strip of data.
  220.  
  221.       
  222.       AI Format EPS
  223.       -------------
  224.  
  225.       Text is not yet correctly implemented, if you have some sample files in
  226.       AI format which contain text please contact me.
  227.  
  228.       AI format appears to support only non zero winding rule.
  229.       Awaiting Version 3 specs to clarify.
  230.  
  231.       AI format appears not to like move's other than at the beginning of a path
  232.       Awaiting Version 3 specs to clarify.
  233.  
  234.       For the above two reasons some filled objects may not appear correctly
  235.       either use plain format or unfill objects.
  236.  
  237.  
  238. Config File
  239. ~~~~~~~~~~~
  240.  
  241.       This file controls the conversion from Acorn Font names to Postscript 
  242.       font names. 
  243.  
  244.       The format is
  245.       
  246.                #(Acorn Font Name) /(Postscript Font Name) 
  247.  
  248. EPS File type
  249. ~~~~~~~~~~~~~
  250.  
  251.        The EPS file type is 411
  252.  
  253.  
  254. Copyright & Contributions
  255. ~~~~~~~~~~~~~~~~~~~~~~~~~
  256.  
  257. This software carries no warranty, either express or implied. 
  258. I can not guarantee that it is free of bugs or give any warranty
  259. about it’s suitability for use.
  260.                                                    
  261. The status of !Draw->EPS is Careware.
  262.  
  263. Permission is granted to Norwich Computer Services to reproduce
  264. !EPS->Draw on Careware disks.
  265.  
  266. The software will be uploaded to Careware sections on Arcade and
  267. Archive Bulletin Boards, it may only be uploaded by the author.
  268. It may not be uploaded by anybody else or to any other board.
  269.                             
  270. This software may NOT be distributed by public domain libraries.
  271.  
  272. If you did not obtain the software from a Careware disk or by subscription
  273. to one of the Bulletin Board Careware sections.
  274. ( i.e. You obtained it from a friend who does, say. ) 
  275. Then please send a contribution to either
  276.  
  277. Heatherley Cheshire Home
  278. Effingham Lane,
  279. Copthorne,
  280. Sussex.
  281. RH10 3HS.
  282.  
  283. Registered Charity Number : 218186
  284.  
  285. or
  286.  
  287. Chipstead Lake Cheshire Home
  288. Chevening Road
  289. Chipstead
  290. Sevenoaks
  291. Kent
  292. TN13 2SD.
  293.  
  294. The software may not otherwise be copied or distributed without
  295. the Authors written permission.
  296.  
  297. Copyright remains solely the authors. (C) Keith Sloan 
  298.  
  299. Contact
  300. ~~~~~~~
  301.  
  302. If you find problems or want to make suggestions for improvements then
  303. please contact me at either of the following.
  304.  
  305. I may be contacted by electronic mail at the following :-
  306.  
  307. User:  Keith Sloan on ArcadeBBS  : London  081 654 2212 
  308.  
  309.  Fidonet  : Keith Sloan @ 2:254/7.0
  310.  Internet : keiths@cix.compulink.co.uk
  311.  
  312. Wanted
  313. ~~~~~~
  314.                    
  315. In the interest of enhancing this enhance this application I
  316. would like to obtain the following :-
  317.  
  318.     Sample AI format files using
  319.          Single Text font
  320.          Multiple Text fonts
  321.  
  322.     Details of RiscOS 3 Draw file format
  323.  
  324.     Details of RiscOS 3 FontManager and legal copy of.
  325.  
  326.     PICT file format details
  327.  
  328.     Windows Metafile format details
  329.  
  330. If you can help with any of these I would be most grateful.
  331.  
  332. Many Thanks
  333.                     
  334.  
  335. Feedback
  336. ~~~~~~~~
  337.  
  338.  
  339. What are your priority on improvements ?
  340.  
  341.    Other preview formats ( please specify ) ?
  342.    Grey / Colour Preview ?
  343.    Other resolutions
  344.    TIFF Compression ?
  345.    Sprites ?
  346.    Text Areas ?
  347.    Others
  348.  
  349.  
  350. Version History.
  351. ~~~~~~~~~~~~~~~~
  352.  
  353.     BetaTest A   9th  March 1992
  354.     BetaTest E   3rd  May   1992
  355.  
  356.     1.0 : 17th  May   1992
  357.  
  358.         Fix for problem with Grouped items introduced in
  359.         previous release.
  360.         Fix for Filled Areas with No outline colour.
  361.  
  362.     1.1 : 18th May 1992
  363.  
  364.         AI format no output to 2 decimal places.
  365.         AI Format should have been using L not l
  366.         AI format not allowed intermediate Moves
  367.  
  368.     1.2 : 13th July 1992
  369.  
  370.         AI Format correct terminator
  371.         AI Format correction for Intermediate Moves
  372.  
  373.     1.3 : 28th July 1992
  374.  
  375.         AI Format correct text output.
  376.         AI Format Scale Text in x direction
  377.  
  378.     1.4 : 12th October
  379.  
  380.         Preview code complied without Prod flag, causing 
  381.         Debugging preview sprite to be dumped to ram disk,
  382.         causing disk full error messages
  383.  
  384.  
  385.         
  386.